Contents

Title and Copyright Information

Send Us Your Comments

Preface

• Audience
• Documentation Accessibility
• Related Documents
• Customer Support
• Improved Process for Oracle Retail Documentation Corrections
• Oracle Retail Documentation on the Oracle Help Center (docs.oracle.com)
• Conventions

1 Introduction

• Major Features of the RSE Tool
• Concepts
  • What is a Service?
  • Oracle Fusion Reference Architecture (OFRA)
  • Where Does RSE Fit?
• Technical Specifications
  • Supported Operating Systems

2 Installation and Basic Setup

• Determining the Type of Installation
• Installing as a Standalone Application
• Installation as a Web Application in Oracle WebLogic
  • Prerequisites
  • Deploy the Retail Service-Oriented Architecture Enabler
  • Verify the Retail Service-Oriented Architecture Enabler
  • Redeploy the Application

3 Command Line Interface

• Sevice Provider
  • Arguments
  • Commands
  • Service Definition Library XML File
  • Service Definition Library XML File for Restful Web Services
  • Custom Business Objects Jar File
  • Localization Business Object Jar File
  • Service Implementation Jar File
• Service Consumer
  • Arguments
  • Commands

4 Tool Inputs and Outputs

• Tool Inputs
  • ServiceProviderDefLibrary.xml
  • RestServiceProviderDefLibrary.xml
  • XSDs and retail-public-payload-java-beans.jar
  • PL/SQL Oracle Objects
  • WSDL
• Tool Outputs
  • PL/SQL Provider Web Service
  • PL/SQL Consumer using Webservice Call-Out Utility
  • PL/SQL Consumer Web Service
  • Java EE Provider Web Service
  • Java EE Consumer Web Service

5 User Interface Usage

• Service Provider
  • Service Definition Library XML File
  • Service Definition Library XML File for Restful web services
  • Custom Business Objects Jar File
  • Localization Business Object Jar File
  • Service Implementation Jar File
• Service Consumer
• Help

6 Service Definition Library XML File

• Schema Definition
  • serviceProviderDefLibrary
    • Attributes
    • Elements
• Managing the Service Definition Library XML File
  • Creating the File
  • Changing the Version of the File
  • Changing the appName Attribute in the File
  • Renaming a Service or Operation Name in the File
  • Adding a New Service or New Operation to the File
  • Deleting a Service or Deleting Operations from the File
  • Defining New Exceptions to the Operations
  • Using Different Versions of Objects as Input/Output to an Operation

7 Service Definition Library XML File for Restful services

• Schema Definition
• ServiceProviderDefLibrary
• Validation rules for a service definition xml for RESTful web services
  • Rules for Application Name Field
  • Rules for Service Name Field
  • Rules for Service Operations
  • Rules for Path Parameters
  • Rules for Query Parameters
  • Rules for Links
  • Rules for RelatedTo element
  • JSON output
  • Response Codes

8 Web Service Standards and Conventions

• Web Service Naming
• Web Service Versioning

9 Creating the Java EE Implementation Jar

• Step 1: Generate Web Services with Default Implementation
• Step 2: Implement Interfaces
• Step 3: Upload the jar

10 Implementation Guidelines

• Important Note About this Chapter
• PL/SQL Service Consumer Implementation Notes
• PL/SQL Provider Service Implementation Notes
• Java EE Service Consumer Implementation Notes
  • Sample Client Code
• Java EE Service Provider Implementation Notes
  • Use Case 1: Complete the Generator Provided Stub Code Implementation
  • Use Case 2: Provide a Custom impl jar to the RSE Tool
  • Use Case 3: Package the Generated Service Classes in an Existing Application
• Web Service Call as a Remote EJB Call
  • Prerequisites
  • Procedure
  • Code Description
• Web Service Call as a POJO Call
  • Procedure
  • Sample Code for POJO Invocation
• Deploying the Web Service
  • Redeploy the Service Application
  • Verify the Service Application Installation Using the Administration Console
• Creating a JDBC Data Source

11 Implementation Guidelines

• Important Note About this Chapter
• PL/SQL Consumer using Web Service Call-Out Utility Implementation Notes
  • Install Oracle JVM Web Services Call-Out Utility
    • Verify environment variables and export if needed
    • Create OJVMWCU_INSTALL User
    • Install OJVMWCU
    • Grant permission and create synonyms
    • Grant permission to the user
    • Load RBO Oracle Objects into the database
    • Create activity logging table
    • Load WebService java code into database
    • Load WebService plsql code into database
• PL/SQL Provider Service Implementation Notes
• Java EE Service Provider Implementation Notes
  • Use Case 1: Complete the Generator Provided Stub Code Implementation
  • Use Case 2: Provide a Custom impl jar to the RSE Tool
  • Use Case 3: Package the Generated Service Classes in an Existing Application
• Deploying the Web Service
• Creating a JDBC Data Source in WebLogic

12 Web Services Security Setup Guidelines

• Client-Side Setup
  • Java Client Setup
  • PL/SQL Client Setup for WS with Call-out
  • PL/SQL Client Setup

A Appendix: Installer Screens

• Installation as a Web Application in Oracle WebLogic
  • Deploy the Retail SOA Enabler Application
  • Creating the rseAdminGroup
  • Verify the Retail SOA Enabler Web Application
  • Redeploy the Application

B Appendix: Sample ServiceProviderDefLibrary.xml

• ServiceProviderDefLibrary.xml
• RestServiceProviderDefLibrary.xml

C Appendix: Creating a JDBC Data Source

• Procedure